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1.0 INTRODUCTION 


‘The Diagnostic/Utility System III (DUSIII) is a memory-resident 
means of running diagnostic and utility programs on the HP 30341A 
HP-IB Interface Module attached to an HP 3000 Series III Computer 
System. The Stand-Alone File Manager (FMGR) is a tape-based 
software module forming the heart of DUSIII. In addition to the 
FMGR, DUSIII includes AID together with a set of AID programs and 
supporting files. Generally, those programs provided in support 
of the Operating System are classified as Utilities and programs 
whose primary function is to test hardware and firmware subsys- 
tems or peripherals are classified as Diagnostics. Independent 
of operating systems, the FMGR gives you access to files (located 
On tape) and enables you to modify, delete, add, or create those 
files. Also, a tape-based directory allows interchange of file 
information with other tapes. DUSIII is compatible with any HP 
3000 Series III Computer System with an attached HP 30341A HP-IB 
Interface Module attached (HP3000 Series III HP-IB version com- 
puter system). 


It is assumed that the operator is familiar with the nomenclature 
used in describing keyboard terminals and the Control Panel. 


It is implied that all user inputs are terminated with ENTER, 
Carriage return on the console device. 

1.1 HARDWARE REQUIREMENTS 

The following hardware is required: 


An HP 3000 Series III HP-IB version computer system consisting 
of: 


(1) Memory - 128K words minimum 


(2) Console ~- any terminal supported on tapes created by 
SDUPII 
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(3) Tape ~ HP 7970B/E Magnetic Tape Unit (Used as a cold load 
device). The tape unit must be connected to the 
multiplexer channel of the Series III. 


OR 
- HP 7976 Magnetic Tape Unit 


(4) Printer (Optional) - Any printer supported by SDUPII 
The figure below depicts how the FMGR integrates with other pro- 
gram modules. 


MEMORY 

TAPE DEVICE gt tn nen nen nnn nnn enn : 

6 SS SS ee ee e CSS SSeS eS ee e | 

| Diagnostic/ [<-->] | Enter Your Program Name |"----. | 

| Utility Sys- | | I: | 

| tem III Tape | | Om mo a nn ee re mn ee ne we nw oe : | 

| | | valid responses are: i 4 

| i l i | 

|} aeeseeseee== - | | 6S Seen =: Sess s= . | 

| | Directory | | | JAID type file |->Load and | 

| and | | a= == -=2-===-= . execute AID i oi 

| Files | | program file-' | 

[iss eSre= wae | | 1 | 

ac aa " | i | 

| I 4 

KEYBOARD | Palate eaten . H | 

CONSOLE | |MANAGER | ----~--- >Execute DUS---' | 

Cee Te ee ee ee ° | Cm mmm : | | 

| Operator [<-->] | | 

| Interaction | | | 
ee ' 

| 14 

| i | 

| il 

| i | 

OPTIONAL PRINTER | Peale e | | 

a essa SaaS eSs . | | AID [eee e--- >Execute AID-~--' = | 

| Hardcopy <-->] {ses<-e= . | 

| Output | | | 

° t ° t 


DUSIII Structure 
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2.0 INTRODUCTION 


This section covers the specific Operating instructions required 
to load DUSIII and to manipulate the file Manager portion of 


DUSIII. 


2.1 LOADING THE SYSTEM 


(1) Perform an MPE 'SHUTDOWN' to Properly logoff every current 
session, if applicable. 


(2) Run the terminal Self-Test and verify the displayed results. 

(3) Fully reset the terminal. 

(4) Ensure that the terminal is in REMOTE. 

.(5) Install a DUSIII Tape on the Cold-Load Tape Unit. 

(6) If the cold-load device is an HP 7970B/E, set. the Control 
Panel Switch Register to %3006. If the cold-load device is 
an HP 7976, set the Switch Register to: 

0 cCCc DDD 01 111 101 
where: CCCC = channel number (binary) to which the device is 
attached and DDD = device number (binary) of 
the device. 

(7) Press HALT; then press ENABLE and LOAD. 

(8) Set the Switch Register to the number assigned to DUSIII (one 
if DUSIII is the only program put on the tape by SDUPII or 
2 if tape contained the GIC diagnostic). 

(9) Press RUN. 

(10) DUSIII will be loaded from tape. 


(11) Press the RETURN key on the terminal to speed-sense_ the 
terminal. 
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(12) The welcome message and prompt are displayed: 


Diagnostic/Utility System III revision XX. XX 
Enter your program name (Type HELP for program information) 


(The revision is determined by the latest release date of the 
FMGR program. ) 


(HELP is an AID program that presents file and command 
information. ) 


2.2 RUNNING DUSIII PROGRAMS 


To execute an AID program file, enter the program name as 
follows: 


Enter your program name. (Type HELP for program information. ) 
:PROGNAME (The program PROGNAME will now be loaded and executed) 
| 
| 
(Upon completion of the program, DUSIII returns to its entry 
mode. ) 
| 
Enter your program name. (Type HELP for program information. ) 


2.3 USING THE FILE MANAGER 


If you wish to create, modify, or inquire about files, type 
"MANAGER". You will be prompted with: 


Stand Alone File Manager 
Enter Command (LC for List Command) 
> (Any DUSIII command may now be executed. ) 


2.4 USING AID 


If you wish to create, modify, or make changes to an AID program, 
you may do so by typing "AID". The resulting interaction is des- 
cribed in the AID Diagnostic Lanaguage Reference Manual located 
in this binder. ; 
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3.0 INTRODUCTION 

The information in this section pertains to the file management 
structure and how diagnostic and utility programs are classified. 
3.1 FILENAMES 


Filenames are restricted to eight alphanumeric ASCII characters 
starting with an alpha character. 


Valid Filenames Invalid Filenames 
TEST ADIAG 
D44TEST : TEST. 
ADCCDIAG «TEST 
B AB/TEST 


Note: The filenames DIREC, IDSBOOT and SCRATCH are reserved. 


3.2 FILE TYPES . 


Internally, files are typed as follows: 


Type Description Created by 
AID AID program AID SAVE Command 
DATA data file CREATE Command. 


The AID type constitutes the programs available to the user. The 
DATA files are transparent to the user but are accessed by some 
of the programs. 


3.3 FILE CLASSES 

File classes have no significance to DUSIII. They are provided 
for the support of software which reads the directory. AID files 
are classified according to the service they provide. There are 
two classes of program files: UTILITY (U) and DIAGNOSTIC (D). 


Data files are classified by content: ASCII (A), BINARY (B). 
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At file creation time, each AID program file is classified as a 
DIAGNOSTIC and all DATA files as ASCII. The CLASSIFY Command may 
be employed to change the classification as required. 


3.4 FILE ACCESS 


The FMGR user may access any file on any DUS Tape. In other 
words, if you have entered an AID program and cannot save it be- 
cause of lack of space, you may remove the currently installed 
DUS Tape, install another, and again attempt to save your pro- 
gram. (This process is repeatable indefinitely.) Similarly, if 
you need a file that does not reside on the currently installed 
DUS Tape you can remove it, install another, and determine wheth- 
er or not the new tape contains the file you want. 


Note 


"DUS tape" refers to both DUS tapes used with the 
HP 3000 Series 30/33/44 and DUSIII tapes used with 
the HP 3000 Series III. AID programs and data files 
can be transferred between computer systems by load- 
ing a file (LOAD PROGRAM) from one system, exchang- 
ing tapes, and saving the file (SAVE PROGRAM) in an- 
other system. 


There are some restrictions when accessing certain types of 
files. Most of these restrictions will be pointed out throughout 
this document, however a few general rules apply: 


- The files DIREC and SCRATCH* are permanent files; they cannot 
be modified in any way. 


- The files DIREC, and SCRATCH can be read; but only SCRATCH can 
be written.. 


_- Files that are protected must be unprotected before alteration 
(See CHANGE Command). 
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4.0 INTRODUCTION 


The FMGR contains a command set that allows alteration of and 
access to files. The commands are explained in detail on the 
following pages. For convenience, some parameters are optional; 
optional parameters are enclosed in brackets[]. The operator may 
input any valid command after DUSIII prompts with: 


Enter Command (LC for List Commands ) 
> 


Any error in syntax, or errors which occur during command execu- 
tion, are identified by a message which should be easily under-~ 
stood by the operator. However, should difficulty arise under- 
Standing an error message, refer to Error Messages Section V. 


4.1 CHANGE 

OPERATION NAME: Change file security 

MNEMONIC: CHANGE filename TO U[NPROTECTED] 

CHANGE filename TO P[ROTECTED] 

DESCRIPTION: Allows the operator to protect or unprotect a file. 
A protected file indicates it is not PURGEable and 
is read-only. 

EXAMPLES(S): Enter Command (LC for List Commands) 
>CHANGE DIAG4 TO P (changes the file DIAG4 to a non- 

PURGEable and read only file) 
Enter Command (LC for List Commands) 


>CHANGE DIAG4 TO U (change DIAG4 to a PURGEable 
read/write file) 
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4.2 CLASSIFY 
OPERATION NAME: Reclassify a file 
MNEMONIC: CLASSIFY filename AS class 


DESCRIPTION: This Command has no significance to DUSIII, but 
provides support for software which accesses the 
directory. It allows the user to reclassify the 
file's filename to a new class where; 


class = U(TILITY] 
D{IAGNOSTIC] 
A[SCII] 
B[INARY ] 


EXAMPLE(S): Enter Command(LC for List Commands) 
>CLASSIFY DATA1 AS B (changes the file DATA] to a 
BINARY classification) 


4.3 CREATE 
OPERATION NAME: Create a data file 


MNEMONIC: CREATE filename, number of 128 word blocks [,revi- 
sion] 


DESCRIPTION: Creates (i.e., adds to the directory of files) an 
ASCII data file named "filename" which will be 
X number of word blocks long (e.g., the number en- 
tered multiplied by 128). The range for the number 
of word blocks is 1 <# number of word blocks ~= 310. 
If the optional revision is not added, then the re- 
vision 00.00 is used. (See LF command for the for- 
mat of revision. ) 


EXAMPLE(S): Enter Command (LC for List Commands) 
>CREATE TEST,4, 01.02 (creates an ASCII data file 
TEST with a length of 512 (= 


4*128) words and a revision of 
01.02) 


4.4 EXIT 
OPERATION NAME: Leave file manager 
MNEMONIC: EXIT 


DESCRIPTION: Causes computer to leave the file manager and return 
to the DUSIII entry mode. 
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EXAMPLE(S): Enter Command (LC for List Commands ) 
>EXIT 


Enter Your Program Name 


4.5 Lc 
OPERATION NAME: List the file Management commands 
MNEMONIC: LC 


DESCRIPTION: Lists the File Manager Commands followed by a short 
description of what the command does. 


EXAMPLES(S): Enter Command (LC for List Commands ) 
>LC 


LF List the file directory 


4. 6 LF. 

OPERATION NAME: List the file directory 

MNEMONIC: LF [P[RINTER]] | 

DESCRIPTION: Lists the file directory of the resident DUSIII Tape 
which contains all pertinent information for the 
user. If the optional PRINTER is entered, the di- 
rectory will be listed on the system printer device. 


EXAMPLE(S): Enter Command (LC for List Commands ) 
>LF 


Stand Alone File Directory 


File- 

name Type Class P/U Length File Num Revision Prog Data Stack 
TEST AID U P 427 0 00.00 320 28123 107 
ABC DATA A U 1280 1 00.00 0 0 0 
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The list 


Filename - 


Type 


Class 


P/U 


Length 


File Num - 


Revision - 


Prog 


Data 


Stack 


header has the following meaning: 


The name of the file. 


The currently designated file type. (See File Types 
paragraph 3.2 for explanation of type meanings. ) 


Classification of the file. (See File Classes para- 
graph 3.3 for explanation of class meanings. ) 


Designates whether the file is Protected or Unprotect- 
ed. 


The length of the file in words. This length is cal- 
culated as follows: 


AID type = size of the AID program before execution 
DATA type = created size 


Logical File Number on Tape. 
A five-digit code with the following format: 01.02 


where 01 signifies the major revision level and 
02 signifies the minor revision level. 


This length in words is calculated as follows: 


AID type = program area (object code) of the AID program. 
DATA type = no significance. 


This length in words is calculated as follows: 


AID type = buffer area available for the AID program. 
DATA type = no significance, 


This length in words is calculated as follows: 


AID type = (number of AID statements in the program x 2) 
DATA type = no significance. 


832-10 


4.7 LOAD 


Diagnostic/Utility System III 


OPERATION NAME: Load file into memory 


MNEMONMIC: 


DESCRIPTION: 


4.8 PURGE 


LOAD filename 


Loads a file into the memory. This command would 
typically be used for modifying a file (i.e., LOAD, 
modify memory, SAVE) or for transferring a file from 
One tape to another (i.e., LOAD, switch tapes, SAVE). 


OPERATION NAME: Purge File 


MNEMONIC: 


DESCRIPTION: 


EXAMPLE(S): 


4.9 RENAME 


PURGE filename 


Allows an operator to erase a file from a_ tape. 
Only Unprotected files may be purged. If a protect- 
ed file must be purged, the operator must change the 
file to unprotected and then purge it. (See CHANGE 
command. ) 


Enter Command (LC for List Commands ) 
> PURGE DIAG 


OPERATION NAME: Rename File 


MNEMONIC: 


DESCRIPTION: 


EXAMPLE(S): 


4.10 SAVE 


RENAME old name, new name 


Allows the operator to change the name of a file. 
No other characteristic of the file is changed. 


Enter Command (LC for List Commands) 
>RENAME DIAG], DIAG44 (DIAG1 becomes DIAG44 (i.e. 
DIAG1 no longer exists). 


OPERATION NAME: Save a file by storing it ona tape 


MNEMONIC: 


DESCRIPTION: 


SAVE filename [, revision] 


Stores the AID or DATA file that is currently in 
memory onto the System tape. This command would 
typically be used for modifying a file (i.e., LOAD, 
modify memory, SAVE) or transferring a file to 
another tape (i.e., LOAD, switch tapes, SAVE). If 
the optional revision is not added, the current 
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revision of the file is used. (See LF Command for 
revision format. ) 


EXAMPLE(S): Enter Command (LC for List Commands ) 
>SAVE DIAG, 01.02 
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5.0 INTRODUCTION 


This manual section discusses the possible error conditions that 
may occur during DUSIII operatons. 


' 5.1 FIRMWARE TRAPS 


If the machine firmware detects a condition that takes control 
from the executing user program (e.g., BOUNDS VIOLATION, STACK 
OVERFLOW) because of either a software or hardware problem, the 
following message is printed on the System Console: 


Example: **SYSTEM FAILURE** 
While executing FILENAME 
Delta P=%341 Code Segment= sd 
Stack Overflow 


Delta P equals the octal offset from PB+0. Code segment equals 
the code segment that was executing when the failure occurred and 
finally, a descriptive message indicating the nature of the 
failure (i.e., Stack Overflow in this example). The system is 
halted and, if RUN is pressed, an attempt to return to the DUSIII 


entry mode is made. 


5.2 ERROR MESSAGES 


Message Meaning 


Invalid Filename The filename parameter did not meet the 
requirements of a valid filename. (See 
FILENAMES Section. ) 
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Error on Directory 
write! Media is 
probably no longer 
usable! 


File Directory Full 


File access violation 


File system 
unaltered 


No such file 


Not a Diagnostic/ 
Utility System 


While writing an updated directory, a 
write and subsequent retry failed. The 
directory may be in one of the following 
states: 


1) Invalid data was written, meaning the 
DUSIII file system media is no longer 
usable. 


2) No write actually occurred, meaning 
the DUSIII media is intact with the 
last file operation disregarded. 


3) Enough data was written, before the 
error occurred meaning the DUSIII 
media would be intact with the last 
file store operation successful. 


In any case, try a new cold-load and LF 
Command to ascertain the condition of 
the DUSIII Tape. 


The current operation would exceed the 
58 filename directory entries limit. 
Alternatives include PURGEing a file or 
using another tape. 


This error occurs when a file access is 
attempted on a file or file type that is 
not compatible with the command or oper- 
ation, e.g. RENAME oldfile,newfile where 
newfile exists already or an attempt is 
made to alter the files DIREC, IDSBOOT, 
or SCRATCH. 


Can occur during a command such as SAVE. 
A recoverable error occurred with no 
alteration of the directory. Retries of 
the last operation may be attempted. 


Indicates that the specified file 
does not exist in the resident DUSIII 
Filename Directory. Check for misspel- 
ling or try another DUSIII Tape. 


Indicates an attempt was made to store a 


file onto a tape other than a DUSIII 
Tape. 
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Invalid Command 


or Input 
Abort!! System not 
usable 


**SYSTEM FAILURE** 


No File in memory 


File Protected 


Invalid Revision 


Can Not Write Past 
End Of Tape 


Magnetic Tape 
Transfer Count 
Is X, Should Be Y 


Magnetic Tape 
Failure N 
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The command requested or parameters 
following it do not conform to the 
required command structure. Execute an 
LC command or refer to the command 


description to ascertain the correct 
format. 


The last operation resulted in an irre- 
coverable error. Verify correctness of 
the last operation. Cold load to 
attempt restart. 


See Firmware Traps paragraph 5.1 of this 
document. 


A SAVE Command was attempted when no 
valid file is resident in memory. See 
LOAD command. 


An attempt was made to PURGE a file 
which has been designated as protected. 
See CHANGE command for changing 
protected status. 


The revision input did not meet the 
syntax requirement. See LF Command for 
the expected format. 


Tape is full. Purge the last file or use 
another tape. 


Last transfer using system tape was 
incomplete. 


N Value Meaning 
$31 EOT 
$12 EOF 
%73 Back Space From BOT 
$44 SIO Failure 
$54 Unit (7970/7976) Failure 
$144 Channel Failure 
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NOTES 
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